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System 

Installation 


Sun386l Ailvanced Administration 


There are two books tliat cover aclmhiistration for the Sun386i workstation— Sun3S6i 
SNAP Administration and Sun386i Advanced Administration, Tliis section contains 
corrections and additions to Sun3S6i Advanced Administration. For corrections 
and additions to Sun3S6i SNAP Administration^ see the Sun3S6i Owner's Bulletin 
for SunOS 4.0.1. 

The Sun3S6i Advanced Administration manual may be useful to you as a system or 
network administrator. This book provides information on topics such as manually in¬ 
stalling systems and creating user accounts, installing third-party software, reparti- 
tioning disks, Yellow Pages, and advanced network administrative tasks. Every site 
should have at least one copy of Sun3S6i Advanced Administration. Tliis book is part 
of two documentation sets—the Sun386i Owner’s Supplement Documentation Set 
(part no. SR-9B) and the Sun386i Documentation Conversion Set (part no. SR-9D). 

The Conversion Set mcludes books specific to tlie Sun386i workstation, that is, books 
not included in the standard SunOS 4.0 documentation set. 


This section contains software and documentation notes pertaining to Chapter 1 of 
Sun3S6i Advanced Administration. 


Connecting systems to a network - You can install systems more quickly and use 
fewer resources if you connect tliem one at a time to the network. Although you can in¬ 
stall multiple diskful systems simultaneously, the process wiU take longer per system 
and will make it more difficult for the server to do anything else. However, you cannot 
install multiple diskless systems simultaneously. Connect diskless systems to the net¬ 
work one at a time. 


Installing diskless $un3B6i workstations on odier networks - You can now in¬ 
stall a diskless Sun386i system on a non-Sun386i network. Sun386i SunOS 4,0.1 in¬ 
cludes a server kit that allows a Sun-3 or a Sun-4, running SunOS 4.0 and Yellow Pages, 
to support a diskless Sun386i system. See the section on the server kit, within these 
notes, for details on how to install tlie server kit and subsequently mstall diskless 
Sun386i systems. 


Installing diskAil Sun386i systems on $un3S6i networks - The directions for 
manually installing a diskful Sun386i system as a network client are incomplete. Step 6 
on page 5 of Sun3S6i Advanced Administration should state: 

6. Connect the system to the Ethernet. The system then displays a list of choices. Se¬ 
lect choice l-“Create or join a network.” Then, the system displays several 
messages and finishes booting. It is now installed on the network. 


Diskless client support - SNAP does not display both of the parameters—disk space 
limitation and client numter limitation—that control whether a boot server can ac¬ 
cept a diskless client. It only shows tlie client number limitation. After tlie disldess cli¬ 
ent is installed, there must still be at least 40 Mbytes of free space on the disk that the 
diskless client is using. The diskless client’s root and swap areas may be on different 
disks, affecting this calculation. Swap space defaults to id Mbytes. 
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The defaults are set so tliat a 91 Mbyte server will not accept diskless clients and a 327 
Mbyte server, witli no extra software installed, will accept more clients than are advis¬ 
able for performance reasons. 

The /etc/bootservers file sets the parameters for how the boot server will serve its 
clients. See the Yellow Pages chapter of the Sun386i Advanced Administration 
manual for an explanation of this file. Tlie sixtli field will usually have the value 
“40000” (40 Mb^es). If this is set to zero, tlien the only disk space requirement is that 
there is 8 Ml^ytes of free space for a diskless client’s root area. (Note that the Sun386i 
Advanced Administration manual contains an error in the description of the 
/etc/bootservers file—the descriptions of the last three fields are in the wrong 
order. See the note under the “Yellow Pages” section later in these notes, for a correct 
description of this file.) 


The following are general things to consider when installing Sun386i systems on a 
mixed network. 

Set up a Sun3B6i as a YP master - If possible, you should set up a Sun386i system as 
the YP master for other Sun386i clients on your network. This is because: 

♦ You’ll be better able to organize and control installation. 

♦ Automountmg features are more consistent with the Sun386i systems being served. 

♦ The YP domain can take advantage of Sun386i YP maps not available on Sun-3 and 
Sun-4 YP masters (for example, ypprintcap). 

♦ Sun386i systems in this Yellow Pages domain can take advantage of SNAP, Automat¬ 
ic System Installation, and New User Login features. 

If you already have a YP domain, you should either convert your network to use the 
Sun386i YP domain, or you should set up the Sun386i systems on tlie existing network. 
Do not set up two YP domains. 

System administration with non-Sun386i YP masters - If you are using a Sun-3 
or Sun-4 workstation as the YP master for Sun386i systems, you must administer 
Sun386i systems manually. 

You cannot use SNAP, Automatic System Installation, and New User Login features; 
tliese are only available if a Sun386i system is the YP master for the domain. 

Networks without Yellow Pages -- If your network is not using Yellow Pages, you 
must set up a Sun386i master server. See page 166 of Sun386i SNAP Administration. 

Turning off automatic installation features - Even on all-Sun386i domains, it’s 
sometimes desirable to disal:)le Automatic System Installation or New User Login. See 
Chapter 1 of Sun386i Advanced Administration for instructions on how to turn off 
tliese features. 

Even with these features disabled, you can continue to use a Sun386i master server. 

Diskless clients - If you are using a Sun-3 or Sun-4 as the bootserver for a Sun386i dis¬ 
kless system, keep the following points in mind: 

♦ The bootserver must be running SunOS release 4.0 or greater. 


System 
Installation on 
Mixed Networks 
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Network 

Administration 


♦ The setup_client, setup_exec, and suninstall procedures do not current¬ 
ly accommodate Sun386i diskless clients—^you must use tiie Sun386i server kit in¬ 
stead. 

For more information on support of diskless clients, see the section “Sun-3 and Sun-4 
Server Kit for Sun386i Diskless Systems " later in these notes. 

Subnets - Subnets are set up automatically using the YP netmasks .byaddr map. If 
this map does not exist, and you need to set up a system on a subnetted network, see 
Sun386i Advanced AdministraUon for details of what to do. 

Installing applications - Keep in mind that the /usr partition on Sun386i systems is 
mounted read-only. When you are installing or reinstalling an application, follow the 
vendor’s instructions aix)ut where to store the files on Sun386i systems. If you have de¬ 
veloped your own applications, refer to tlie Sun3S6i Developer's Guide for further in¬ 
formation. 


This section contains software and documentation notes pertaining to Chapter 2 of 
Sun3S6i Advanced AdministraUon. 


Changing a domain name - The instructions for changing the domain name on a 
Sun386i network (of standalone system) given on pages 18-19 of Sun3S6i Advanced 
Administration are incomplete. After step 3, perform the following additional step: 

3a. Delete the file/var/yp/net id. time 

Without this additional step, all secure RPC-based applications (such as SNAP, Auto¬ 
matic System Installation, and New User Account generation) will fail RPC authentica¬ 
tion. 


Multiple domains on a network - You cannot have two Sun386i YP domains on the 
same network, even after setting the policies as described on page 19 of Sun386i Ad¬ 
vanced Administration. This is because the DRARP daemon cannot be completely 
disabled by setting the ip_address_allocation policy to none . 

Disabling root logins - To disable root logins on die console, you must remove the 
secure field and the ~n option from die console entry in the /etc/ttytab file. If 
you remove die secure field from the console in /etc/ttytab and do not disable 
logintool by removing the -n option, users can still log in as root if diey know the pass¬ 
word. 


Secure NFS - To use secure NFS™, you must reconfigure your SunOS kernel to in¬ 
clude DES encryption code. You do this by enabling the CRYPT option. (This is omit¬ 
ted from page 27 of Sun386i Advanced Administration.) See System and Network 
Administration, included in the Owner’s Supplement Documentation Set, for details 
on how to reconfigure die kernel. 


Publickey credential problem - On a Sun386i network, user accounts (and the 
superuser for a system) may use some special audientication information stored in the 
publickey .byname Yellow Pages map. This is used for the Secure RPC authentica¬ 
tion system, which enhances the security of the network. 
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Sometimes a user will experience problems with some applications using his or her ac¬ 
count. In particular, if the network administrator deletes a user’s entry from the 
/etc/publickey file and rebuilds YP, various systems will incorrectly think that the 
user is using tlie old entry in this map. 

Secure RPC applications, such as secure NFS or SNAP, sometimes generate errors with 
RPC credentials or verifiers. The problem will often go away if you delete the file 
/etc/keystore from the system where tlie user logged in, and then reboot. 

Systems may experience a similar prol>lem. After deleting the publickey entry for a 
system from the /etc/publickey file, you must delete the /etc/. rootkey file on 
that system, along with /etc/keystore, before you reboot the system. 


Locking services on non-Sun386i home directory servers - If Sun386i users 
have tlieir home directories stored on a Sun-3 or Sun-4 workstation, you should up¬ 
date the locking services (the "lock daemon”) for these machines. Without tliis up¬ 
date, Sun386i users whose home directories are served by a Sun-3 or Sun-4 workstation 
may see DOS and other applications "hang” when they try to use them. For non-Sun 
home directory servers, see the note at tlie end of these instructions. 

To perform the update: 

1. Instruct users to quit all applications. 

2. Locate the Sun386i SunOS 4.0.1 diskette labeled "Sun3/4 Lockd Fix Diskette.” This 
diskette contains tlie locking service changes to upgrade the servers. Insert this dis¬ 
kette into tlie Sun386i drive (you’ll perform this update over the network). 

3. Create a temporary directory on tlie Sun386i system to hold the new software: 
system:!} snkdir /tnqp/lockd 

system:2} cd /tnc^/lockd 

4. Copy tlie lock daemon software from tlie diskette using tlie following command: 
system:3} bar xvZpf /dev/rfdOc • 

5. Remotely log into the server as root (for server, substitute tlie system name of the 
system you are updating): 

system: 4} rlogin server -1 root 

6. Kill the existing rpc. lockd process. Use the following command to see the pro¬ 
cess ID: 

SUPERUSER) ps -ax I grep lockd 

Then use kill -9 followed by the process ID to kill the lock daemon process. (See 
Sun3S6i Advanced for information on the kill command.) 

7. Change to tlie directory containing the lock daemon software. 

On a server rumiing SunOS 3.x software, enter cd /etc 

On a server rumiing SunOS 4.0 software, enter cd /usr/otc 

8. Rename tlie original lock daemon software: 

SUPERUSER} mv rpc.lockd rpc.lockd.old 

9. Copy the new file from the Sun386i system to the server. (For system, substitute the 
name of the Sun386i system on which you loaded the lock daemon software. For 
arch, substitute Sun3 or Sun4 as appropriate.) 

SUPERUSER} rep system : /tmp/lockd/arcfe/rpc. lockd • 

10. Restart the locking service: 

SUPERUSER} rpc.lockd 
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12. Log off tlie server by typing logout. 

13. Remove the temporary lock daemon flies you loaded earlier onto the Sun386i sys¬ 
tem: 

system:5) cd /tn^ 
system:6} rm —r£ lockd 

Users of DOS Windows™ and other Sun386i applications will need to wait at least 45 
seconds before restarting their applications. 

Notes No lock daemon update is available for non-Sun systems. Tlierefore, there is no 
network-wide locking for users witli home directories on non-Sun systems. However, 
locking between windows on a single Sun386i system works fine, even with no locking 
services. But you should be sure that a single user doesn’t run DOS when logged onto 
two or more machines at the same time, and that more tlian one user does not try to 
access DOS on the same Sun386i system at the same time. Also, be sure that no one 
uses DOS applications that require file locking. 

If people are u.sing a non-Sun .system as a home directory server, add the following 
line to users’ . login flies to prevent an error message from being displayed on the 
Sun386i system when a DOS window starts up : 

setenv DOS LOCKING OFF 


Sunlink DNI driver change - If you’re using SunLink™ DNI, you must modUy the 
DNI driver for it to work correctly under SunOS 4.0.1. See tlie note on tliis topic in the 
“System Software" section of the Sun386i Developer’s Notes, later in tliis document. 


Shutting down diskless clients — As root, you cannot use the shutdown command 
to shut down a diskless client. You must be a member of the operator group to do 
tliis. However, you can use the halt command (as root) or tlie Shut down option 
on tlie SunView™ menu to shut down a diskless client. 


This section contains software and documentation notes pertaining to Chapter 3 of 
Sun386i Advanced Administmtion. 


Creating user accounts on standalones and Sun386i networks - The instruc¬ 
tions for creating user accounts, documented on pages 32-34 of Sun386i Advanced 
Administration, are incorrect. Steps 9 and 10 should be reversed; also, steps 11 and 
12 are incorrect. Perform steps 1-8, and then the following four steps (9^12): 

9. Create the directory /export/home/groM/>n«me if it does not already exist. 

Hien create a symlxilic link in / export by entering the following command: 

In -a /£^y.aa/h.ama/gtxfupname/usemame \ 
/^•poxt./hoam/groupname/usemame 

10. Place a copy of the files in -gTOM/uinme/defaults in the user’s home directory. 
You can use tlie following command to do this provided that none of tliese files 
have been protected against remote root access. If this is the case, you will have to 
go to the system containing these flies and copy tliem from there; then return to 
tlie user’s home directory server. 

~gm»/>f«iitfe/copy_hoine ~groupname ~usemame 
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11. Change the ownership of tlie user’s home directory and its files to the new user, us¬ 
ing the chown command: 

chown -R username .groupname ~usemame/. 

12. Export the new user’s home directory by entering the following commands: 
echo ' /nxpoxt./iitxnB/groupname/usemame -access=domain' »• /etc/exports 
export£s —a 

Stop being superuser by entering tire exit command. 

Now complete tire instructions on page 34, steps 13 and 14. 


Printers, 
Terminals, and 
Modems 


Hiis section contains software and documentation notes pertaining to Chapter 4 of 
Sun386i Advanced Administration. 

Adding an AT bus serial card - The procedure for adding an AT serial card on pages 
41 and 42 of Sun386i Advanced Administration is incorrect. Follow the procedure 
documented here. 

You can add up to two additional serial ports to your system by installing AT-compati- 
ble serial boards, and then activating SunOS software required to operate the boards. 
Serial boards installed this way are accessible to both Dc5s and SunOS systems. Stan¬ 
dard AT COM1/COM2 boards provide one or two serial ports. Multiport (4, 8, or 16) 
serial boards are also available from some PC equipment vendors, but you must use a 
third-party driver or your own custom-written driver to access them. 

Follow these steps to complete the installation of a serial card and make it accessible 
to DOS: 

1. Set the switclies or jumpers on tlie serial card or modem card for the appropriate 
interrupt levels and I/O addresses. You may choose COMl (interrupt level 4, ach 
dress 3f 8, port name ttymO), COM2 (interrupt level 3, address 2f8, port name 
ttyml), or both. Tlien install the board or card in the system unit. Consult Ap¬ 
pendix B of Sun386i System Setup and Maintenance as well as the note on tliis 
in the Sun386i Owner’s Bulletin for SunOS 4.0.1. 

2. After starting up your system, use tlie su command in a Commands window to be¬ 
come superuser. 

3. Enter the following command to edit the system’s rc. local file: 

SUPERUSER} textedit /etc/rc.local 

4. Remove the # symbol from tlie following line: 

#modload ats.o -exec ats.script -conf ats_conf && chat 'AT 
serial port driver.' 

5. Save the file and quit the Text Editor. 

6. Still as superuser, enter the following command: 

SUPERUSER} cd /etc/dos/defaults 

If the serial port is to be used as COM2, enter: 

SUPERUSER} mv com2 coiii2.orig 
SUPERUSER) In -s /dev/ttyml com2 

Note that ttyml will be created by the modload command in step 9 on the next 
page (if it does not already exist). The same is true for ttymO, when tlie serial port 
is COMl. 
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If die serial port is to be used as COMl, enter: 

SUPERUSER) mr coml contl.orlg 
SUPERUSER) In -s /dev/ttymO coml 

7. Clieck your '-/pc/setup, pc file to ensure tliat the comw line you are using is not 
commented out. 

8. Save your work and quit any open DOS window on your Desktop. 

9. Still as superuser, enter the following commands: 

SUPERUSER) cd /etc/modules 

SUPERUSER) modload ats.o -eacac ats.script -con£ ats_con£ 

10. Exit from superuser. The new serial port will be available to DOS and SunOS sys¬ 
tems. 

11. If you see tlie message "vd load: none of the specified devices are on 
line,” this means your serial board is not connected or seated properly. In this 
case, shut down the system and physically reinstall the serial board. Tlien repeat 
steps 1-10 above. 

The installation is now complete. You can use SNAP at this point to add a printer, ter¬ 
minal, or modem to the newly installed port. 



Adding a printer, terminal, or modem - To add one of these peripherals so that it 
can be later maintained using SNAP, you should perform an additional step. (This 
step was omitted from the documentation in Chapter 4.) The device should be added 
to the /etc/ext_ports file. The format of this file allots one line per peripheral, 
witli eight fields. The first two fields are separated by a colon and the rest of the fields 
are separated by a single tab. The fields and values are: 

Field Value 


System name 
Port name 
Peripheral type 
Status 

Baud rate 
Model 

Printer name 


oak, for example 

ttya is the system serial port; ppO is the system parallel port 
printer, terminal, or modem 
on or off for printers and terminals 
in, out, or in_out for modems 

the baud rate of the printer, terminal, or modem; for a printer 
comiected to a parallel port, insert the baud rate of 9600 


hayes, for example 

Ip, for example; there should be one printer named Ip on the 
system or network (this is llie default printer); leave tliis field 
blank when adding a terminal or a mcxiem 

Location this field is optional; if included, a number sign (#) should 

precede the location, making tills field a comment 

The following example adds an Epson™ printer to tlie parallel port on the system 
named oak. The printer is enabled, named Ip, and located in room 39. 


oakrppO printer on 9600 epson Ip #room 39 


Add the printer to the /etc/ext_ports file beforeyou issue the make command 
(step 3 on page 42 of Sun3S6i Advanced Administration). 
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For modems and termhials, you need to also issue the make command. After entertog 
tlie modem or terminal in the /etc/ext_ports file, enter the following command 
as superuser: 

SUPERUSER} cd /var/yp/make 


Adding a printer to a non-Sun386i system - Wlien you add a printer to a non- 
Sun386i system, you should perform the following steps to make the printer available 
from the Sun386i systems. 

If tine Yellow Pages master is a Sun386i system: 

1. Log in to the YP master and become superuser. 

2. Add an entry to the file /etc/ypprintcap, in the following format: 
name: lp=:rm=systemname: r:p=-name: sd=/var/spool/ name 

where name is the name of the printer, for example, lp3, and systemname is the 
name of tlie system tliat the printer is connected to. 

3. Enter the following command: 

SUPERUSER) cd /var/yp; make 

If the YP master is not a Sun386i system: 

On each system from which you want to access the printer, perform the following: 

1. Log in and become superuser. 

2. Add an entry to tlie file /etc/printcap, in the following format: 
name: lp=: rae^systemname: xp’^name: sd=/var/spool/ name 

where name is the name of the printer, fix example, lp3, and systetnname is the 
name of the system tliat tlie printer is connected to. 


File System 
Structure 



Adding a Hayes 2400 modem - The instructions for adding a modem on pages 49- 
52 of Sun386i Advanced Administration are incomplete for the Hayes® 2400 
mfylpm See the “Hayes 2400 modem” note ki the Sun386i SNAP Administration 
section of the Sun386i Owner’s Bulletin for SunOS 4.0.1 for details on installing this 
modem. 


This section contains software and documentation notes pertaining to Chapter 5 of 
Sun386i Advanced Administration. 


The root (/) file system - The root file system contains the directory stand. This 
information was omitted from pages 59 and 60 of Sun386i Advanced ^ministration. 
Tlie /stand directory is the directory for hardware diagnostics. It contains a standa¬ 
lone copy program, tape boot program, and a copy of tlie boot program. 


The /files ffle system - The /files file system no longer contains the directory 
vol. local. The contents of tliis director, as descrilied on page 66 of Sun386i 
Advanced Administration, are now contamed in the directory 
/files/vol/local. 


The /export file system - The /export/vol/local subdirectory is no longer a 
symbolic Ikik to /files/vol. local. It is a symbolic Ikik to /f iles/vol/local. 
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Installing 

Third-Party 

Software 


Repartitioning 
and Restoring 
Disks 


Yellow Pages 


UUCP files — Some files contained in /usr/lib/uucp are now contained in 
/ etc/uucp. 


Tills section contains software and documentation notes pertaining to Chapter 6 of 
Sun3S6i Advanced Administration, 


Loading third>party applications -- Step 2 of the “Pre-Installation Steps” section 
(page 74 of Sun3S6i Advanced Administration) has an error. The line 

/vol/local/bin. arc/i 

should read: 

cd /vol/local/bin.arc/l 


Exporting an application or director 3 r - Tlie command to ensure that the directory 
/export/vol exists (step 2, page 76 of Sun386i Advanced Administration) is no 
longer needed. You do not need to perform tliis step with SunOS 4.0.1. 


Registering an application - If you performed the additional steps for registering an 
application with an icon (page 78 of Sun386i Advanced Administration) using the 4.0 
. orgrc files, these files must be replaced with the new ones. Tlie 4.0 . orgrc files are 
incompatible witli the 4.0.1 Sun Organizer™. See Installing Sun386i SunOS 4.0,1 for 
more details. 


Automounter - The automounter has an option that allows it to select one of many 
servers to satisfy a particular automount request. For example, if /vol/local is repli¬ 
cated on more than one server, tlie following auto. vol map entry allows the auto¬ 
mounter to mount from any one of the hosts listed in the map entry: 

local hostl:/usr/local host2:/usr/local host3:/usr/local 

This has the advantage that the automounter can satisfy the mount request if one or 
more of the servers is unavailable. However, this option does not work on the 4.0.1 
automounter. A patch will be made available tlirough customer support for customers 
requiring this feature. 


This section contains software and documentation notes pertaining to Chapter 7 of 
Sun386i Advanced Administration, 


Increasing swap space ~ In the instructions for increasing swap space, steps 4 and 5 
on page 88 of Sun386i Advanced Administration are reversed; perform step 5 first, 
tlien step 4. 


This section contains software and documentation notes pertaining to Chapter 8 of 
Sun386i Advanced Administration. 
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The /etc/bootservers file - There is an error in the description of the file 
/etc/boot servers on page 104 of Sun386i Advanced Administration. The last 
tliree fields are in tlie following order, witli corrected values: 

Field Value 

Minimum free Kbytes in tmp 8 Mbytes 

Minimum free Kbytes in root 40 Mybtes 

Minimum free Kbytes in swap 0 

Mail This section contains software and documentation notes pertaining to Chapter 9 of 

Sun386i Advanced Administration. 

Administering mail - Mail is delivered to users’ home directories. If users have any 
liome directories on non-Sun386i systems, they will have to log in on tlieir own sys¬ 
tems to read their mail. 


Creating mailing lists - SNAP does not maintain mailing lists for groups in the for¬ 
mat shown on page 115 of Sun386i Advanced Administration. Mailing lists for groups 
are contained in the file /etc/ypaliases, in the following format: 

groupname: username^ username, username 


Undelivered mail - Tlie Sun386i system is set up to have users’ mail delivered to 
their home directories. If users are not receiving their mail, it miglit be because the 
mail is not going to tlieir home dliectories. Be sure that: 

♦ /usr/ucb comes before /bin or /usr/bin in the users’ search paths (in the 
• login, .cshrc, or .profile files) 

♦ The MAIL environment variable is set in the users’ . login flies 

After correcting either of these two problems, you need to log out, then log in again, 
to effect these changes. 


Back Up and 
Restore 


Wlien you specify the Z option with bar, bar uses the /tmp directory to compress 
and uncompress files. If there is not enough room in the /tmp directory for bar to 
copy a file and compress or uncompress it, the file will he added to the bar archive 
uncompressed, or extracted from tlie bar archive and left in its compressed format. 
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Sun-3 and Sun-4 Server Kit for Sun386i 
Diskless Systems 


About the 
Server Kit 


The Sun386i SunOS 4.0.1 tape media includes all the files required to allow a Sun-3 or 
Sun-4 system to act as a server for one or more diskless Sun386i machines. The server 
kit components are: 

♦ These notes 

♦ Sun386i Application SunOS distribution tape 

♦ Sun386i Developer’s Toolkit distribution tape (optional) 

Tlie server kit is intended for use by persons who have some understanding of Sun net¬ 
works. Do not attempt to use it if you do not understand the concepts of IP addresses, 
Ethernet addresses, or Yellow Pages. 

The server kit makes the following assumptions: 

1. That the Sun-3 or Sun-4 server is running SunOS version 4.0 or greater. 

2. That the Sun-3 or Sun-4 server is in a Yellow Pages domain. 

If you have a diskful Sun386i system already installed on the network, then a Yellow 
Pages domain is present. If no Yellow Pages domain is present, one must be set up 
(see the System and Network Administration manual). 

3. That the server system and the diskless Sun386i clients reside in the same Yellow 
Pages domain. 

If the server system and the Sun386i clients are in different domains you must per¬ 
form several manual steps in addition to running tlie server kit scripts. 

4. Tliat the server system is the Yellow Pages master server for the domain. 

If the server system is not the Yellow Pages master server for the domain in which 
die server and clients reside, you must perform several manual steps in addition 
to running the server kit scripts. 

5. Tliat you do not need to use SNAP and New User Accounts facilities on the diskless 
Sun386i systems. 

If you have a dislcful Sun386i system installed on the network, it is preferable to use 
this system as the Yellow Pages master server for the domain. This will allow 
limited use of SNAP and New User Accounts on die diskless Sun386i systems. 

Notes It is highly recommended that die server be a Yellow Pages master or slave serv¬ 
er. Administration of multiple Yellow Pages domains on a network is complicated and 
error-prone. 

There are three steps to installing the server kit, covered in the following sections: 

1. Loading the Server Kit Scripts 

2. Running die sun386server Script 

3. Setting Up die Diskless Sun386i Clients 
The final three sections discuss: 

♦ Manual procedures for loading optional clusters (if you do not load them when you 
run the server kit scripts) 

♦ How to remove a diskless Sun386i client from a non-Sun386i server, and 

♦ What files are modified by the server kit scripts 
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Loading the 
Server Kit 
Scripts 


Running the 

sun386server 

Script 


The server kit scripts are in tar format on file 4 of the Application SunOS tape. The 
tapes are available in two sizes: 

♦ 1/2-inch reel tape (6250 bpi) 

♦ 1/4-inch cartridge tape (QIC-24) 

The server kit scripts should be loaded in the Sun-3 or Sun-4 directory 
/usr/etc/install. To load the scripts: 

1. Become superuser on the server by typing su and then entering the root pass¬ 
word. 

2. Grange directories to /usr/etc/install by typing the following: 

cd /usr/etc/install 

3. Load the Application SunOS tape into the tape drive. 

4. Load the scripts from tape by typing the appropriate commands from the table 
below. The server kit is available only on 1/4-inch tape as of 4.0.1. 



Local 

Remote 

From 

1/2" 

Tape 

Drive 

mt -f /dev/nrmt8 rew 
mt -f /dev/nrmt8 fsf 3 
tar xvpbf 64 /dev/nrmt8 

rsh host mt -f /dev/nrmt8 rew 
rsh host mt -f /dev/nrmt8 fsf 3 
rsh host dd if*=/dev/nrmt8 bs=64b 

1 tar xvpBbf 64 - 

From 

1/4" 

Tape 

Drive 

mt -f /dev/nrSt8 rew 
mt —f /dev/nrst8 fsf 3 
tar xvpbf 64 /dev/nrst8 

rsh host mt -f /dev/nrSt8 rew 
rsh host mt -f /dev/nrst8 fsf 3 
rsh host dd if=»/dev/nrst8 bs=64b 

1 tar xvpBbf 64 — 


In the above table, host is the name of the remote system. Terminate each of the three 
command lines listed in the table witli a carriage return. A list of server kit files will ap¬ 
pear on your screen. 


Once you have loaded the server scripts from the Application SunOS tape, you must 
run tlie seiver kit script sun386server. This script, run on your Sun-3 or Sun-4 sys¬ 
tem, allows it to serve Sun386i systems. Tlie script requires you to enter the following 
information: 

♦ Tape size (1/4-inch) and location of drive (local or remote) 

♦ Where to load Sun386i software components (described below) 

♦ What Sun386i Application SunOS and Developer*s Toolkit optional clusters to load 
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The sun386server script loads software from the Sun386i distribution tapes into six 
different directories on tlie server system. You are allowed to specify where these six 
paths will be. Where you choose to locate these six directories depends on your partic¬ 
ular file system layout and disk space availability. The first tiiree directories are similar 
to tliose required by any diskless Sun system: 

♦ The executable path—where the Sun386i /usr file system will be loaded. The /usr 
file system requires about 20 Mbytes of disk space. The default executable path is 
/export/exec. 

♦ The root path—^where the roots for Sun386i clients will be created, llie default root 
path is /export/root. Each diskless root requires about 2.2 Mbytes of disk space. 

♦ The swap patli—^where the swap files for Sun386i clients will be created. Tlie default 
swap path is /export/swap. Each Sun386i diskless client requires a 16 Mbyte swap 
file. 

Tlie final tliree paths are specific to the Sun386i diskless systems: 

♦ The cluster path—where the Sun386i optional clusters are loaded. The entire set of 
Application SunOS clusters requires about 13.5 Mbytes of disk space and tlie entire 
set of Developer's Toolkit clusters requires about 17.5 Mbytes of disk space. The de¬ 
fault cluster path is /export/cluster. 

♦ The local path—^the /usr/local directory for the Sun386i clients. The default lo¬ 
cal patli is /export/local. No software is initially loaded into this directory. 

♦ The help patli—where the help files will reside. The default help path is 
/export/help. This directory is automounted as /vol/help on the Sun386i cli¬ 
ents. By default it contains symlxjlic links to the default help files in 
/usr/lib/help. 

Notes The Application SunOS tape must be loaded in the tape drive before you run the 
sun386server script. 

The following instructions show how to run the sun386server script to set up a Sun-3 
system named f red as a server for diskless Sun386i clients. Files are lieing loaded re¬ 
motely from a Sun-4 system named barney. The default paths (defaults appear in 
square bracket.s) are accepted by pressing the fRetum 1 key. What you should enter is 
shown in boldface type. 

1. Change directories by typing the following: 

cd /usr/etc/in8tall/sun386 

2. Execute tlie script: 

8un3868erver 

3. The system responds with: 

What size are your distribution tapes? 

1 - 1/4" 

2 - 1 / 2 " 

Enter [1-2] : 1 

As of 4.0.1, tlie server kit is available only on quarter-inch tape. 

4. Tell whether you are loading from a local or a remote tape drive. 

Are you loading from a remote tape drive? (y/n): y 

If you are loading from a remote tape drive, you will be prompted to provide the 

name of the remote host to which the tape drive is attached. 

Enter the remote host name: barney 
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5. Type in the executable path (where tlie Sun386i /usr file system will be loaded). 
Enter the executable path [/export/exec] iLBsSoJ 

Executables will be loaded in a subdirectory of the path you specify in this step. 
The subdirectory will be lal:>eled sun386 - sunos4.0.1. In this example, the full 
executable path is /export/exec/sun386. sunos4.0.1. 

6. Type in the root path (where tlie root directories for Sun386i clients will be creat¬ 
ed). 

Enter the root path [/export/root ] : 

7. Type in the swap path (where tlie swap files for Sun386i clients will be created). 
Enter the swap path [/export/swap] ilEstuaiJ 

8. Type in the cluster path (where the Sun386i optional clusters are loaded). 

Enter the cluster path [/export/cluster ]: CeSuEO 

Clusters will te loaded in a subdirectory of the path you specify in this step. The 
subdirectory will be labeled sun386. sunos4.0.1. In tixis example, the full clus¬ 
ter patli is /export/cluster/sun386. sunos4.0.1. 

9. Type in the local path (the /usr/local directory for the Sun386i clients). 

Enter the local path F/export/locall i lRcturtTl 

Tlie actual path used will be a subdirectory of the local path you specify. Tlie sub¬ 
directory will be labeled sun386. sunos4.0.1. In tliis example, the full local 
path is/export/local/sun386. sunos4.0.1. 

10. Type in the help path (where the help files will reside). 

Enter the help path f/export/help! : lRetum1 


11. The system then asks whether you want to load all the Application SunOS Optional 
Ousters. 

Note: Tlie load and loadc commands that allow you to load Application SunOS and 
Developer’s Toolkit clusters are not available on Sun systems other than the Sun386i 
system. Once you run the sun386server script, clusters can only be loaded manual¬ 
ly using the procedure outlined in the “Loading Clusters Manually” section. There¬ 
fore, you should load all the clusters you tlimk tliat you will need at the time you run 
tlie sun386server script. 

Do you want to load all the Application SunOS optional 
clusters? (y/n) : y 

If you respond by typing y, all the clusters will eventually be loaded (see step 13 of 
tills procedure). If you respond by typing n, you will be prompted for each cluster 
individually. It’s a good idea to load all clusters. 

12. The system then asks whetlier you want to load all the Developer’s Toolkit optional 
clusters. 

Note? You should respond to tlie following questions by typing n unless you have a De¬ 
veloper’s Toolkit tape and plan on loading clusters from it at tliis tune. 


Do you want to load all the Developer's Toolkit optional 
clusters? (y/n): n 
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Setting Up the 
Diskless 
Sun386i Clients 


If you respond by typing y, all the clusters wUl be loaded. If you respond by typing 
n, you will be prompted for each cluster individually (see below). 

Do you want to load the base_devel cluster? (y/n) : y 

Do you want to load the sysV^devel cluster? (y/n): n 

Do you want to load the config cluster? (y/n): n 

13 . The ciii.sters you specified in the above steps are now reaciy to be loaded. Insert 

Application SunOS tapel into tlie tape drive and confirm by typing y in response 
to tlie following prompt: 

Insert Application SunOS tape 1, confirm (y/n): y 
You will see tlie following messages as files are extracted: 

Positioning tape ... 

Extracting contents of stand and sbin ... 

Extracting contents of /usr ... 

Extracting help files ... 

Extracting the extended__commands cluster ... 

If you chose to load any of the Developer’s Toolkit optional clusters in step 12, 
you will be prompted to place the Developer’s Toolkit tape into the tape drive, 
and the clusters will be loaded. Otherwise, the server configuration is complete. 

Once your machine is set up as a Sun386i server, you can install Sun386i clients at any 
time by running the sun386client script (as root on the server). For each Sun386i 
system you want to install, you must run the sun386client script once, providing 
the following information: 

♦ Client’s Yellow Pages domain (default is domain of server) 

♦ Client’s host name 

♦ Client’s IP address 

♦ Client’s Ethernet address 

♦ All tlie systems on which home directories of users of the client machine will reside 
(see “A Note About Home Directories” on tlie next page) 
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A Note About 
Home DIreotories 


Running tbe 

sun386client 

Script 


The sun386client script performs all functions necessary to install the client, except in 
cases where: 

♦ The server is not the Yellow Pages (YP) master server for the client’s YP domain 

♦ The server is not the YP master server for its own YP domain 

In these cases tlie script will instruct you to perform one or two simple manual steps 
(including rumiing another script on the Yellow Pages master server) to complete the in¬ 
stallation of the diskless client. If the YP master server is a Sun386i system, after perform¬ 
ing all necessary manual steps, log on as superuser to tlie YP master server and type: 

cd /var/yp; make 


In order to retain compatibility with Sun-3 and Sun-4 conventions, access of home direc¬ 
tories from diskless Sun386i clients on Sun-3 or Sun-4 servers requires explicit specifica¬ 
tion of the server machine in the path. 

For example, users of the client machine may have their home directories on the server 
machine, but users may also have home directories on any diskful machine in the net¬ 
work. 

The case illustrated earlier m the server kit section assumes a network configuration like 
that shown below, in which some of the home directories for users of Sun386i client peb¬ 
bles are stored on the server fred, but others are stored on a machine called barney. 



After you install diskless Sun386i client pebbles as shown in “Running the 
sun386client Script” (below), the home directories for users of pebbles can be ac¬ 
cessed by tlie paths /home/fred and /home/barney. Tliis is because, while running the 
sun386client script, both fred and barney are specified as home directory servers 
for pebbles. (See step 7 on the next page.) 

In this case, the home directory for user xerxes resides on system fred and is accessed 
by the path /home/f red/xerxes. The home directory for user yolanda, on the other 
hand, resides on system barney and is accessed by the path /home/barney/yolanda. 


The following instructions show how to run the sun386client script to install the 
diskless Sun386i client pebbles in Yellow Pages domain YP . caveman. com. The system 
pebbles has IP address 121.2.121.212 and Ethernet address 9:8:76:5:4:3c. 

1. Running as root on system fred, change directories by typing: 

cd /usr/etc/install/sun386 

2. Execute tlie script: 
sun386cllent 
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3. Enter the YP domain in which you are installing the diskless Sun386i client. 

Enter the YP domain for this client fYP . caveman. coml : 1 Return 1 

4. Enter the host name of the diskless Sun386i system. 

Enter the host name of this client: pebbles 

5. Enter the IP address of the diskless Sun386i system. 

Enter the IP address of this client: 121.2.121.212 

6. Enter the Ethernet address of the ciiskless Sun386i system. 

Enter the ethernet address of this client: 9:8:76:5:4:3C 

You can find out the Ethernet address of the system by powering it on and observ¬ 
ing tlie power-on banner. 

7. Enter the host names of any and all machines on which the client’s home directo¬ 
ries reside (as explained in “A Note About Home Directories” on the previous 
page). 

Enter the host name(s) of the home directory server (s): 

£red barney 

You will see the following messages: 

Updating Yellow Pages hosts map for domain software -.. 
Updating Yellow Pages ethers map for domain software ... 
Updating Yellow Pages bootparams map for domain software ... 
Updating Yellow Pages auto.master map for domain software 

Updating Yellow Pages auto.vol map for domain software ... 
Updating Yellow Pages auto.home map for domain software ... 
Creating 16M bytes of swap for client pebbles ... 

Creating root for client pebbles ... 

Repeat this procedure for every diskless Sun386i client you want to install on the Sun-3 
or Sun-4 server. For example, to install bambam and dino as clients of f red, you 
need to run tlie sun386client script two more times. 

When you have finished running the script, you should boot tlie diskless Sun386i sys¬ 
tem by turning on tlie power switch. 


Notes There is a bug in the sun386client script which can initialize diskless Sun386i 
clients with an incorrect time zone. 

The prolilem appears only in tlie Central, Mountain, and Pacific time zones of 
the U.S. Tlie time zone of the client is set to GMT (Greenwich Mean Time) instead 
of CST, MST, or PST (Central, Mountain, or Pacific Standard time zones). 

If this happens you must reset the time zone on the client. To do tliis, on the client 
system log on as root and type the following commands: 

rm /ebc/localbime 

In —s /usr/share/lxb/zonei.n£o/l/mezoiie /ebc/localbime 
bzsebup 
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where timezone is one of the following; 

♦ CST6CDT— Central Standard time zone 

♦ MST7MDT—^Mountain Standard time zone 

♦ PST8PDT—Pacific Standard time zone 

If you need to load Application SunOS or Developer’s Toolkit clusters after running 
the sun386server script, you must follow tills manual procedure for each cluster. 

1. Become superuser on the Sun-3 or Sun-4 server machine by typing su and then 
entering the root password. 

2. Change your current working directory to the directory where the clusters are 
loaded. 

For Application SunOS clusters, this directory is: 
c/w5^e;p(af^/?/sun386. sunos4.0.1/appl 

For Developer’s Toolkit clusters, this directory is; 
clusterpath/su.n3%6, sunos4.0.1/devel 

In these paths, clusterpath represents the path where optional clusters are loaded. 
This is tlie same path you specified in step 8 of the “Running the sun386server 
Script” section, earlier in these notes. 

3. Load the appropriate tape (Application SunOS or Developer’s Toolkit) in the tape 
drive. 

4. Wind the tape to the point that contains the cluster you want to load (use the com¬ 
mands in the table below); 



Local 

Remote 

From 

1/2" 

Tape 

Drive 

mt -f /dev/nrmt8 rew 
mt -f /dev/nrmt8 

fsf pos 

rsh host mt ~f /dev/nrmt8 rew 
rsh host mt -f /dev/nrmt8 

fsf pos 

From 

1/4" 

Tape 

Drive 

mt ~f /dev/nrSt8 rew 
mt -f /dev/nrst8 

fsf pos 

rsh host mt -f /dev/nrst 8 rew 
rsh host mt -f /dev/nrst8 

fsf pos 


In the above table, host is the name of the remote system and pos is tlie position in the 
tape of die cluster in question. Check the list on the next page to find out the position 
of die clusters you want to load. 
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Application SunOS: 

Cluster Position 


extended_coinmands 5 

spellcheck 6 

doc_prep 7 

networkingjplus 8 

comm 9 

name_server 10 

accounting 11 

disk_quotas 12 

audit 13 

advanced__admin 14 

mail_plus 15 

old_commands 16 

plot 17 

sysV^commands 18 

man_pages 19 

games 20 


Developer’s Toolkit: 


Cluster Position 


base__devel 2 

sysV^devel 3 

proflibs 4 

plot_devel 5 

sees 6 

sunview__devel 7 

help_guide 8 

dos_net_toolkit 9 

config 10 


5. Extract the cluster from the tape by typing the appropriate command from the ta¬ 
ble below. Only 1/4-inch tape is available at this time. 



Local 

Reoiote 

From 

1/2" 

Tape 

Drive 

tar xvbf 64 /dev/nrmt8 

rsh host dd if-/dev/nrmt8 
ibs«32k obs=20b 

1 tar xvpBbf 20 — 

From 

1/4" 

Tape 

Drive 

tar xvbf 64 /dev/nrst8 

rsh host dd if=/dev/nrst8 
ibs=32k obs=20b 

1 tar xvpBbf 20 — 


where host is the name of the remote system. The cluster is now loaded. Repeat 
steps 2 tlirougli 5 for eacli cluster you want to load. 
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Removing a 
Sun386i Client 


At the present time, there is no command to remove a diskless Sun386i client from a 
server that is not a Sun386i workstation. However, you can follow manual steps to re¬ 
move a Sun386i diskless client. The following example shows the removal of the 
Sun386i client named pebbles that was added previously. 

1* Halt the client. Log in to pebbles and select the ExltS=>ShutdOWIl option from 
tlie mam menu. 

2. Become superuser on the server (in this case, Sun-3 system f red is the server) by 
typing su followed by the root password. 

3. Remove the client's link in /tftpboot. 

Each diskless system's link in /tftpboot has the format inetaddr, S386 where in- 
etaddr is the hexadecimal (l>ase 16) representation of tlie client's IP address. The 
IP address for pebbles is 121.2.121.212. The hexadecimal representation is 


derived as follows: 



121 

2 121 

212 

decimal IP address for pebbles 

i 


i 


79 

02 79 

D4 

hexadecimal representation 


You can remove the link for pebbles in /tftpboot with the following com¬ 
mand: 

rm -f /t£tpboot/790279D4.S386 

4. Unexport the client's swap and root files and remove their entries from 
/etc/exports. 

The root and swap file entries for pebbles in /etc/export will look like: 

/export/root/pebbles -root*=pebbles,access=pebbles 
/export/swap/pebbles —root=pebbles,access^pebbles 

Unexport these files by typing the following commands: 

exportfs -u /export/root/pebbles 
exportfs —u /export/swap/pebbles 

Edit the /etc/export file and delete the root and swap entries for pebbles. 

Note: The files /export/root and /export/swap are the root and swap paths 
specified in steps 6 and 7 of the “Running the sun386server Script" section (earlier 
in these notes). You may have specified different root and swap paths. 

5. Remove the client's root and swap areas. Type the following commands: 

rm -rf /export/root/pebbles 
rm -£ /export/swap/pebbles 

6. Log in to the Yellow Pages master server and become superuser. 

Type su followed l:3y the root password. (In this case, Sun-3 system f red is the 
Yellow Pages server-superuser is already logged on.) 

7. Remove the client’s entry in /etc/hosts. 

The entry for pebbles in /etc/hosts on the Yellow Pages master server will 
look like; 

121.2.121.212 pebbles 
Remove this line. 
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8. Remove the client’s entry in /etc/ethers. 

The entry for pebbles in /etc/ethers on the Yellow Pages master server will 
look like: 

7:8:76:5:4:3c pebbles 
Remove this line. 

9. Remove the client’s entries in /etc/bootparams. 

The entry for pebbles in /etc/bootparams on die Yellow Pages master server 
will look like: 

pebbles root-fred:/export/root/pebbles \ 

swap-fred:/export/root/pebbles \ 
usr=fred:/export/exec/sun386.sunos4.0.1 

Remove these three lines. 

10. Update the Yellow Pages maps for hosts, ethers, and bootparams. 

The Yellow Pages maps on the seiver are in /var/yp. Update them by typing the 
following commands: 

cd /var/yp 

xoaka hosts ethers bootparams 
This concludes the manual procedure to remove a Sun386i client. 


Files Medified 
by the Server 


Several files are modified l^y the server kit scripts when you run those scripts on the 

server system. These files are listed in tills section. 

Files modified by the sun386sarvar script: 

♦ llie /etc/exports file is modified to export the executable path, the cluster path, 
the local path, and the help path. See the "Running the sun386server Script” sec¬ 
tion earlier in these notes for more information on these paths. 

♦ The /etc/inetd. conf file is modified to run tftp (only if the system isn’t al¬ 
ready a boot server) 

♦ The /tftpboot directory—Sun386i boot programs are copied to tliis directory. 

Files modifi^ by the sun386clxant script (on the server): 

♦ In the swap path a swap file is created for the client: swappath/client 

♦ In the root path a root file system is created for tlie client: rootpath/client 

where rootpath and swappath are the root and swap paths you supply to the 
sun386server script, and client is host name of the client being added. In the 
example in the “Running the sun386server Script” section, the files created 
would lie /export/swap/pebbles and /export/root/pebbles. 

♦ The /etc/exports file is modified to export the swap file and root file system to 
the client. 

♦ A link file is added to the /tftpboot directory. The link file, whose name is the IP 
address of the client (in hexadecimal representation) provides a link to tlie Sun386i 
boot program. 
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Files modified by the 8un386cliant script (on the Yellow Pages master 

server): 

Note: In most cases the server and the Yellow Pages master server are the same 

system. 

♦ The /etc/hosts file—^The client's name and IP address are added. 

♦ Tlie /etc/ethers file—^The client's name and Ethernet address are added. 

♦ The /etc/bootparams file—^Entries to specify the client's root, swap, and /usr 
directories are added. 

♦ /etc/auto.master, /etc/auto.home, and /etc/auto, vol—^Tliese files are 
automount maps, lliey are created unless your Yellow Pages master server is a 
Sun386i workstation (in which case they already exist). 

♦ /var/yp/Makefile—^If your Yellow Pages master server is a Sun-3 or Sun-4 sys¬ 
tem, this file is modified to include entries for die automount map files above. 
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The notes in this section apply to the Developer’s Toolkit software and tlie Sun386i De- 
veloper’s TooUdt Documentation Set. Other information intended for developers in¬ 
cludes the Sun386i 4,0.1 man Page Supplement (see your Sun sales representative if 
you didn’t get a copy and want one) and Sun3S6i Developer ’s Guide Replacement 
Pages (these are the same replacement pages included with the 4.0 version of the Ad¬ 
ministrator’s & Developer’s Notes; you may ignore them if you’ve updated your 
Sun3S6i Developer’s Guide the earlier set). You should also review tiie Sun386i 

Owner’s Bulletin for SunOS 4,0.1 for a look at tlie user-level release notes shipped 
with each Sun386i system. If you’re upgrading your software from tlie 4.0 version, see 
Installing Sun386i SunOS 4,0,1, In particular, check the “Summary of Changes” sec¬ 
tion and the “Compatibility” section of the installation notes. 


Hardware 


Using a mounted file system on the diskette diive - Tlie diskette drive is a .slow 
device. It is inadvisalile to use scripts that mount the diskette, copy a file to it, and 
tlien unmount it. If you do use a script to copy files, run sleep(l) for about 20 sec¬ 
onds liefore unmounting tlie diskette. This does not apply to cases where you copy 
files with the tar(l) or bar(l) commands, but applies only to instances when you use 
a mounted file system on tlie diskette. 


System 

Software 


Capabilities not included by default - Tlie default kernel (the one tliat resides in the 
root file system for each system) is configured for the system on which it runs. For 
most customers, this kernel includes all the functionality that they will need. Several 
SunOS features not included in the default kernel are: 

Diskful Systems: 

♦ disk quotas (quota) 

♦ system accounting (sysacct) 

♦ C2 security auditing (sysaudit) 

♦ Secure NFS support (crypt) 

♦ TCP debugging code (tcpdebug) 

Diskless Systems: 

♦ disk quotas (quota) 

♦ system accounting (sysacct) 

♦ C2 security auditing (sysaudit) 

♦ TCP debugging code (tcpdebug) , 

♦ Secure NFS support (crypt) 

♦ file system code for local disks (uf s) 

♦ NFS server code (nf sserver) 

♦ SCSI driver code (wds and sdO) 


If you need any of these capabilities, you can build a new kernel l^y loading the 
base_devel and conf ig subset clusters, which are part of the Developer’s Toolkit 
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software. The configuration files for the kernel are found in /sys/sun386/conf. 
You can find directions for rebuilding kernels in System and Network Administra¬ 
tion (included in tlie Sun386i Owner’s Supplement Documentation Set). 


Security enhancements - Several security flaws in the SunOS system were exposed 
by a widely~pul.>licized virus (teclinically a worm) that attacked some systems on the 
DoD Internet. Though the Sun386i system was not affected by this program, tlie securi¬ 
ty flaws that it e^q^loited in the background administration programs sendmail and 
f ingerd have been eliminated in this release. 


Changing the block size of a disk - When you change the block size of a di.sk, the 
file system block size must be greater than or equal to the system page size (4 Kbytes). 

A file system with a block size of 2 Kbytes is unsupported because the Sun386i page size 
is 4 Kb^es. A file system with a block size equal to or greater than the system page size 
is acceptable. 


Core files appear to be very large - Core files of dynamically linked programs pro¬ 
duced \yy SunOS 4.0 or 4.0.1 appear to t:)e very large, having a length over 2 Mbytes in 
many cases (as shown by an Is —1 command). However, the actual size on disk (as 
shown by an Is -s) is often much less, usually about the same as it would be with previ¬ 
ous versions of the system. Such unusually large files contain one or more “holes” of 
unused space. 

If such files (or for tliat matter, any file containing a hole) are copied using a com¬ 
mand such as cp or tar, tlie lioles will be filled in and as a consequence the file will 
actually occupy the amount of disk space indicated by its length. This is not a problem 
if the files are renamed (via mv) or dumped with dump. 


Avoid write-only mmap segments - Programs that map segments with PR0T_WRITE 
but do not contain a corresponding PROT_READ will dump core. Always use botli pro¬ 
tections togetlier. 


Signal handler for divide by zero - The program counter does not advance when a 
program that has a signal-handler for divide by zero encounters a divide-by-zero er¬ 
ror. llie program loops, repeatedly calling the signal-handler and returning to the di¬ 
vide by zero. 


filec requires you to disable scrolling - The file completion mechanism, 
f ilec, does not work in a Command Tool window unless you select the Disable 
Scrolling option from the Command Tool window menu. This turns tlie Command 
Tool window into a shelltool and permits you to use filec. 


quotactl does not work on /detv‘/root* - The disk quota utilities (quotaon, 
quotaof f, edquota, repquota) do not work in conjunction witli the /dev/root 
pseudo-device. If you wish to use disk quotas, you must modify the entries in your 
/etc/fstab file to use tlie actual block device name. Your /etc/fstab file proba¬ 
bly looks sometliing like this: 

/dev/roota / 4.2 rw 1 1 
/dev/rootg /usr 4.2 ro 1 2 
/dev/rooth /files 4.2 rw 1 3 
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If sd2 (the disk in your system unit) is your main disk, then you must change the 
/dev/root entries to /dev/sd2 to use quotas, like this; 

/dev/sd2a / 4.2 rw, quota 1 1 
/dev/sd2g /usr 4.2 ro 1 2 
/dev/sd2h /files 4.2 rw, quota 1 3 

After you have modified /etc/fstab in this manner, you must reboot your system 
for tliese changes to take effect. 


SiinUmk DNI driver change - If you're using version 6,0 of SunLink DNI, you must 
use adb to modify tlie DNI driver, due to a change in the 4.0.1 Ethernet driver inter¬ 
nals. As superuser, do the following steps; 

1. cd /usr/sunlink/dni/sys/sun386 

2. adb -w dni_jdriver. o 

3. dni___swap_type?W 1 

dni__swap__type: 0x0 0x1 

4. Press 1 Control-D J to exit from adb. 

5. Rebuild the kernel according to the directions in System and Network Adminis- 
tration (included in the Sun386i Owner’s Supplement Documentation Set). You 
must have the base_devel cluster of tlie Developer’s Toolkit software loaded to 
rebuild the kernel. 

Building kernels on diskless Sun386i systems - Because the diskless client 
mounts the server’s /export/cluster/sun386. sunos4.0.1 directory read¬ 
only, you cannot configure and build a kernel on a diskless Sun3B6i system. However, 
if your diskless client’s file server is a Sun386i system, then you can build your kernels 
on the file server for the diskless client. If your diskless client’s file server is not a 
Sun386i system, or you still wish to build a kernel on your diskless client, you can use 
the following procedure. 

Warning: Performing tliis procedure enables the diskless client to operate as root in 
the file server’s /files partition. This procedure must be performed by root on both 
tlie diskless client and file server. 

On the file server; 

1. Edit the /etc/exports file to change access for the 
/export/cluster/sun386. sunos4.0.1 line to read; 

^root^cttent, SLCc^as^othercttents 

where client is the diskless client you want to build the kernel on, and otherclients 
are other diskless clients using the same server. 

2. Type export £s -av. 

On the diskless client; 

1. Edit the /etc/f stab file to change mount permissions for /usr/cluster from 
ro to rw. 

2. Type umount /usr/cluster; mount /usr/cluster 

3. Follow the steps for building kernels in the System and Network Administration 
manual—see Chapter 9, Reconfiguring the System Kernel. (This book is in the 
Sun386i Owner’s Supplement Documentation Set.) You must have tlie 
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base_devel cluster of the Developer’s Toolkit software loaded to rebuild the 
kernel. 


5 . 25 -inch diskc^e support - The kernel now supports 5.25-inch diskettes, enabling 
the use of such commands as tar(l), bar(l), and fdformat(l) on these diskettes. 
The Sun386i system includes software driver support only; you must contact your Sun 
sales representative to find out about purchasing a 5.25-inch drive that wiil work on 
this system. 


Utilities, 

Libraries, and 
Inciude Fiies 


Program exit value - Some SunOS commands and utilities incorrectly exit with a 
nonzero value on successful conij^letion. Of these programs, viitually all tliose that 
are commonly used in shell scripts liave been fixed, but you may still encounter some, 
llieir random-valued exit codes could cause problems for shell scripts that rely on the 
exit value of a program in a conditional statement. 


Accessing shared libraries - By default, programs are built to access shared librar¬ 
ies. Ihis is the standard behavior and can only be changed througli the use of tlie 
“Bstatic flag. See tlie ld(l) man page for more information. 

Shared memory segment change - The definition for the largest shared memory 
segment has been changed from SHMPOOL in Release 3.x to SHMSIZE in tlie SunOS 4.0 
system. 


sscan£ function - Tlie sscanf function does not properly handle 0. as a valid float¬ 
ing point string. Use 0.0 instead. 


monitor () function - The monitor () function is in the profiling version of the C 
runtime startup module, /usr/lib/mertO .0, and is cailed during startup in all pro¬ 
grams that link with mertO. o. Prior to SunOS 4.0 tliis function was also part of the C li¬ 
brary, but this is no longer the case. Ihis change is permanent. 


The time command - Wlien your system is heavily loaded, the way the system keeps 
track of program time can l:)ecome distorted. As system activity gets heavier, particu¬ 
larly with increased DMA traffic, the distortion increases. This affects the output of 
both /bin/time and tlie C-shell’s built-in time command, which report the time 
taken by system processes. However, tlie time of day kept by the system remains cor¬ 
rect. 


tip can hang commandtool -- If you try to transfer a large file using tip in a Com¬ 
mand Tool window, the transfer stops and the window hangs, forcing you to quit the 
window and reboot the system to use tip again. To avoid this problem, use tip only 
in a shelltool. 


New 80386-format fonts - System-supplied fonts in /usr/lib/fonts/ 
fixedwidthfonts are now available for both 80386 and 680x0 architectures. The 
fonts with the . i386 extension are in the new 80386 format. As of 4.0.1, dynamicaily 
iinked programs that specify one or more fonts in this directory will automatically use 
the new 80386-specific fonts. Statically linked programs built under 4.0.1 will also use 
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80386 fonts. The 80386-style fonts provide enhanced performance, while the 680x0- 
style fonts are provided for backward compatibility. 

Do not add the .1386 extension to any font file name in any existing or new program 
tliat you write. The 4.0.1 version of the libpixrect. a library automatically appends 
. ±386 to a font file name before trying to open it .so that if the specified font exists in 
tlie 80386 format, that will be the one used. If libpixrect. a cannot open the file, it 
attempts to open the originally specified font file name (minus the . ±386 extension). 
In this way existing static programs continue to run, while new static programs or dy¬ 
namically linked programs gain tlie performance benefits of using the 80386 fonts. 

Statically linked programs that use 680x0-format fonts on the Sun386i system will stUI 
run as of 4.0.1. However, you should relink 4.0 statically litiked programs that use 
tliese fonts for two reasons: 

♦ The 80386-format fonts run faster, and so increase the performance of your pro¬ 
grams. 

♦ The 680x0-format fonts will be phased out sometime in the fliture. 

If you are an applications supplier, it is particularly important for you to relink statical¬ 
ly linked programs that are part of your application l:>efore your next release. As with 
dynamically linked programs, do not change the font file names in your code before 
relinking statically linlced programs. When you relink, libpixrect. a automatically 
reads in 80386-format fonts. 


£ontedit(l) changes - As of 4.0.1, all fonts created with fontedit(l) will be in 
80386 format, and font edit will automatically append tlie extension . ±386 to font 
file names as it creates tlie new font. If you use fontedit to modify any of the system- 
supplied fonts in /usr/lib/fonts/f ixedwidthfonts, all of which are available 
in botli 680x0 and 80386 formats, fontedit changes the 80386 version. Do not use 
the . ±386 extension when specifying a font, fontedit uses libpixrect. a to open 
fonts, and libpixrect. a appends . ±386 to the font name you specify and tries to 
open that file. If a font file with the . ±386 extension does not exist, libpixrect. a 
tries to open the font file name tliat you supplied, fontedit then creates an 80386- 
format font as output and appends . ±386 to tlie file name. 

To specifically edit the 680x0-format version of a font that is also available in 80386- 
format, you must rename the 680x0-format file to a temporary file name and then use 
tlie new file name as input to fontedit. fontedit will produce an 80386-format 
font as output. You can use the fontf lip_to_68k(8) utility (see below) to create a 
680x0-format version of the font. 


fontflip_to_68k and fontflip_to_i386 - Two new utilities let you maintain 
font formats for both tlie 80386 and 680x0 architectures, f ont f lip_to_68k(8) con¬ 
verts any 80386-format font to 680x0 format. Similarly, to convert any 680x0-format 
font to 80386 format, use tlie fontflip_to_i386(8) utility. Botli utilities sliare the 
same man page, which provides details on their use. 

If you use fonteditd) to change any font, tlie output produced will be in 80386 for¬ 
mat. To apply the changes made to an existing 680x0-format font, use 
f ont f 1 ip__t o_6 8 k. 

By convention, 80386-style fonts have a .±386 extension, while 680x0-style fonts 
have no extension. fontflip_to_68k tries to strip . ±386 from the end of the font 
file name. If the input font file does not have a . ±386 extension, then you must in¬ 
clude the ~o switch in the command line and specify an output file name. 
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Determining font format - To determine whether a font is in 680x0 or 80386 for¬ 
mat, use the f ile(l) command with tlie font file name as an argument. The f ile(l) 
command indicates either: 

vfont — 68k style 

sun386i vfont — 386 style 


Languago Tools Passing assembler files through C preprocessor (cpp) - If you pass an assembly 

language source file through cpp, make sure that the - file line is the first non-empty 
line of tlie file to ensure that it assembles correctly, llie assembler must see the . file 
line before any other nonblank line in the file. You may also use tlie -P switch with 
cpp. If you use the -P switch, preprocessor macros may precede the . file line. 


Debugging 

Tools 


enum, struct, and union arguments to whatls command in dbx - If you enter 
tlie commancb whatis enum, whatis struct, or whatis union in dbx, it refuses 
to accept any furtlier commands, including quit. The only way out is to kill tlie pro¬ 
cess. 


l>ebu(m;ing running processes with dbx - The option that enables dbx to debug a 
process tliat is running, such as a daemon, does not work in 4.0.1. If you try to issue 
the command dbx objectfileprocess-id at the system prompt or the debug objectfile 
process-id command from within dbx, dbx displays an error message stating that the 
process isn’t running. 


adb: single stepping over floating point instructions - Single stepping over float¬ 
ing point instructions with adb sometimes doesn’t work because the PC does not ad¬ 
vance correctly. Instead of single stepping, use breakpoints to get around the floating 
point section. 

kadb: debugging module entry points - You can use kadb to debug the module 
entry point routine. You must set a breakpoint on the kernel routine vd_entry. This 
is the routine which calls tlie module entry point routine. When kadb hits the break¬ 
point, the symbols for tlie module are usable and you can set a breakpoint in the mod¬ 
ule itself. 

Care must be taken to remove kadb lireakpoints before unloading modules. Since 
kadb inserts bpt instructions in the module itself, unloading and loading new mod¬ 
ules while breakpoints are set can cause kadb to insert bpt instructions at incorrect 
places. Tills may cause the system to crash. 


Window 

System 

General 


After tlie General window system notes presented below, the remaining notes in this 
section are organized l>y SunView application. See also the “Utilities, Libraries, and 
Include Files” section earlier in these notes for information about new 80386-format 
fonts and related utilities. 

SunView background color - The default SunView Desktop background color has 
been set to blue. This color can be changed on a per-session basis using Color Editor. 
It can be changed permanently by specifying a different argument to the 
sunview —color command line in a user’s . login file. Removing this command 
line argument altogether causes tlie screen to revert to medium gray, as in 4.0. The su¬ 
peruser’s default desktop color remains gray. 


31 



Sun386i Developer^s Notes 


Sun386i Administrator's & Developer*s Notes - December 1988 


Keyboard software changes - The Sun386i system previously supported 8-bit char¬ 
acter codes only. As of 4.0.1, only l6-bit character codes are permitted. This change 
should only affect you if you recompile any program that uses the KIOCSETKEY or 
KIOCGETKEY ioctl calls; if you recompile, the binary may not run correctly on 4.0 
or 4.0.1 systems. 

If you need to recompile a program that uses KIOCSETKEY or KIOCGETKEY ioctl 
calls, change the ioctl types in your program to KIOCSKEY and KIOCGKEY, respec¬ 
tively. You must also change your structure declaration from kiockey to 
kiockeymap. The difference tetween tlie structures is tliat llie kio_entry field in 
kiockeymap is larger to accommodate l6-bit values. 


Nnm Lock key enabled in all SunView windows - When you press the Num Lock 
key and subsequently press any other key on the right keypad, tlie upper character 
shown on the keycap is generated instead of a function key sequence. This is tme for all 
SunView windows, not just DOS Windows, as was the case for 4.0. If you included a 
workaround in a 4.0 program to enable Num Lock to work properly in all windows, you 
must remove the workaround code for Num Lock to work correctly under 4.0.1. You 
can also issue the disablenumlock command in any window to get Num Lock func¬ 
tionality for 4.0 programs that have a workaround. 


Ifilcrpositioii on open/close events for subwindows within frames - When a 
frame contains a subwindow such as a canvas or a panel, correct interposition on 
open/close events requires more tlian the example described in tlie SunView 1 Pro¬ 
grammer's Guide (pages 297“-298). In particular, tlie sample interposition function 
described there will not catch the case where the user presses the open/close key over 
an open canvas (or otlier suliwindow) contained by the frame. You can correct this by 
looking for events of type ACTION_OPEN in the subwindow or l>y manually storing the 
frame’s state and checking it each time tlie interposition function is entered, for 
example: 

Notify_value 

my__frame__interposer (frame, ie, arg, type) 

Frame frame; 

Event *ie; 

Notify_arg arg; 

Not if y__event_type type; 

static int closed_before = UNKNOWN; 

int closed_now; 

Notify^value value; 

/* let frame operate on the event */ 

value = notify_next_event_func(frame, ie, arg, type); 

/* get frame's current state */ 

closed_now = (int)window_get(frame, FRAME^CLOSED); 

if (closed_before == UNKNOWN) { 
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/* if this is the first call, just record the */ 

/* frame's state */ 

closed_before = closed__now; 

} else if (closed_now !« closed_before) { 

/* else if the window state has changed, record */ 

/* the new state */ 

closed__before = closed__now; 

/* do something, e.g.: */ 

printf("window just %s\n", closed_now? "closed" : \ 
"opened"); 

fflush(stdout); 

) 

return(value); 

} 

Modifying keyboard maps - You can modify workstation keyboard mappings from 
that of the default U.S. keyboard via User Defaults (or by editing .defaults your- 
selO, or by issuing the loadkeys(l) command. You can change key mappings to suit 
your preference, for example, to swap the functionality of the Escape and Caps Lock 
keys. Probably a more common modification will be to enable generation and dis¬ 
play of non-U.S. characters, in scrollable windows only. For this reason, the specifics 
of changing key mappings are covered in the “Internationalization” section later in 
tliese notes. 


4.0 . orgrc files incompatible - For performance reasons, changes were made in 
tlie 4.0.1 Organizer that are incompatible with the 4.0 .orgrc file. These changes re¬ 
late to the color palette section. Previously, this section came at tlie end of the file and 
used color names; in 4.0.1 it appears at the beginning of the file and uses RGB values. 
This change affects your application if it adds colors to the . orgrc file. Your applica¬ 
tion must now add colors to tlie beginning of the file and specify RGB values, not col¬ 
or names. See the . orgrc man page (included in the Sun3S6i 4.0,1 man Page 
Suppletneni) for detailed file format information. 


New developer’s toolkit cluster for PC-NFS programmers - PC-NFS™ Program¬ 
mer’s Toolkit (dos_net_toolkit) is a new cluster in die Sun386i Developer’s Tool¬ 
kit. It is a collection of network libraries and facilities that you can use to write distribut¬ 
ed open network applications for PCs and Sun386i DOS Windows. 

A PC-NFS Toolkit application running in a DOS Windows session can interact with an¬ 
other application diat uses either Remote Procedure Calls (RPC) or the 4.2BSD socket 
interface. I’he application must be built on either the TCP or UDP protocol and run 
on a system that supports RPCs or 4.2BSD, such as: 

♦ A DOS Windows session (on the same Sun386i workstation or a remote one) 

♦ A SunOS session (on the same workstation or a remote one) 

♦ A PC (or 100% compatible PC) 

♦ Other operating systems that support 4.2BSD or RPCs 
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The PC-NFS TooUcit libraries include 4.2BSD socket calls and RPC client calls. If you 
already have a PC-NFS Toolkit application for a PC, you can run it in DOS Windows af¬ 
ter recompiling the source file under DOS Windows. 

To write toolkit applications you will need a copy of the PC-NFS Programmer's Tool¬ 
kit Manual . Call the Sun Telemarketing Department to order a manual or to find out 
more about writing distributed applications for DOS. The toll-free number is 
1-800-334-SUNM. The order number for tlie PC-NFS Programmer's Toolkit Manual 
is PC-NFS-PlK-09. 

5.25-inch drive support - Tlie DOS monitor and DOS BIOS now support both 3.5- 
inch and an external 5.25-inch drive. However, the Sun386i system comes only with a 
3.5-itich drive. To get an external 5.25-inch drive that will work on this system, con¬ 
tact your Sun sales representative. 

User-related DOS changes and additions - You should also review the DOS sec¬ 
tion of the Sun386i Otvnet's Bulletin for SunOS 4,0,1 iot a description of issues that 
affect both users and developers. This section includes information on topics such as 
LIM 4.0 expanded memory support, per-drive file sharing, faster DOS keyboard and 
mouse response, 9600-baud serial support, and faster DOS interrupt response. 


New help^open utility - 4.0.1 includes a new utility, /usr/bin/help_open, for 
sending commands to the Help Viewer via RPC. See the help_open man page for de¬ 
tails. 

-file command line argument - The -file command line argument, while still 
acceptable, is no longer necessary. Both of the following command cause 
help_viewer to start with the document /home/ahinkle/somefile .doc: 

help__viewer /home/ahinkle/some file, doc 
help__viewer —file /home/ahinkle/somefile.doc 

/tn^/help_viewer. lock - 4.0.1 prevents users from starting more than one 
help_viewer process per machine. This is accomplished by locking and unlocking 
tlie file /tmp/help__viewer«lock . 


admin^policies keyword eliminated - Because the SNAP Handbook topic Im¬ 
plementing Administrative Policies has been eliminated m 4.0.1, the keyword refer¬ 
encing this topic, admin_policies, has also been removed from tlie 
sun external. info file. 


Size of bitmap memory pool reduced - For performance reasons, the size of the 
bitmap memory pool was reduced from 200 Kbytes in 4.0 to 65 Kbytes in 4.0.1. The 
bitmap memory pool is the amount of memory Help Viewer allocates for bitmaps 
(images) in Frame Malcer™ documents. This value is set in the file . . /. . / format/ 
Frame/init/bitmaps (relative to the default help directory). Setting it higher al¬ 
lows more or larger bitmaps to appear in documents; setting it lower reduces Help 
Viewer size and thus improves performance. If you see a message like tliis: 

help_^viewer: (FrameMaker) no room in memory pool for raster 

image filename 
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help_viewer: (FrameMaker) you may need to change this file: 

Vvol/help/language/USA-English/.,/../format/Frame/init/ 
bitmaps' 

it means the memory pool is too small. The bitmaps file can be edited to increase 
tlie memory pool size. 


Help Viewer font changes - Tlie 4.0.1 Help Viewer font hierarchy has l^een modi¬ 
fied slightly, allowing it to take advantage of pre-processed, bit-flipped fonts for bet¬ 
ter performance. Also for performance reasons, fewer Frame Maker fonts are used by 
die standard set of Help Viewer handbooks in 4.0.1; dierefore, fewer fonts are 
shipped on disk and loaded by Help Viewer. These changes affect you if you have de¬ 
veloped on-line documentation using one of the fonts no longer shipped. The section 
“More About Help Fonts” later in these notes presents a detailed description of the 
font changes and new hierarchy, plus instructions for adding fonts not shipped with 
die standard system. 


You can change key mappings from the default setting of a U.S. keyboard for current 
and future sessions on a per-workstation basis. The loadkeys(l) command and a Us¬ 
er Defaults option each let you change the mappings for the workstation (not just for 
the user who issued the command) until die system is rebooted. You can also change 
and retain die nondefault mappings between reboots. This section descril^es both 
methods. 

The key tables and commands provided are part of a phased-in approach to interna¬ 
tional support. Please note die following: 

ISO characters ~ You can only generate ISO characters in a scrollable window. That 
is, if you press a key that is mapped to an ISO character, you will only see the ISO char¬ 
acter in a scrollable window. However, you can view ISO characters that are in key ta¬ 
bles in eidier a Shell Tool or Command Tool window. 

DOS Windows - If you use any key table other than the U.S. default, you will proba¬ 
bly be unable to use DOS Windows because it does not interpret the mappings correct¬ 
ly. For this reason, you might want to use the Compose key instead to generate 
international characters. 

The key tables provided with the Sun3B6i system in the 
/usr/share/lib/keytables directory are: 

♦ be lgium__f ranee 

♦ Canada 

♦ denmark 

♦ germany 

♦ Italy 

♦ netherlands 

♦ norway 

♦ Portugal 

♦ spain_latin__america 

♦ sweden__finland 

♦ Swiss french 


Internationaliza¬ 

tion 
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♦ swiss_german 

♦ us 

♦ uk 

You can also edit these flies or create your own. The keytables(5) man page de¬ 
scribes the table layout. Before editing or creating a file in the directory 
/usr/share/lib/keytables, you must first remount the /usr partiUon as su¬ 
peruser with the commands: 

mount —o raiiiount,rir /usr 

If you load the key table file for tlie United States, United Kingdom, Belgium/France, 
Germany, Switzerland/France, or Switzerland/Germany, you can use die keyboard il¬ 
lustrations on pages 122-124 of System Setup and Maintenance (one of the manuals 
included in the Sun386i Owner’s Documentation Set). Keyboard illustrations for the 
otlier key tables provided are not yet available, so you should take careful note of key 
locations before you specify another table. Tliis is iniportant because when you 
cliange key mappings, tlte new mappings automatically remain in affect until you re¬ 
boot the system. When you or someone else using the workstation log out, it could be 
difficult to log in again and get the password correct if you can’t see what you are typ¬ 
ing and if the keys pressed are different from thek key caps. Therefore, you might want 
to: 

1. Print the table file you plan to use. 

2. Compare the hard copy to the on-line version of the table and mark any ISO char¬ 
acters that didn’t print on tlie hard copy. 

3. Look at Figure 10-1 on page 153 of the Sun386{ Developer's Guide which shows the 
key station codes for tlie default keyboard. (This manual is part of the Sun386i De¬ 
veloper’s Toolkit Documentation Set.) 

4. Type /etc/fastboot to restore read-only permission to the /usr partition. 

If you have trouble determining current key mappings, see the “Specifying the Default 
Key Table” section later in this description. 

Tlie loadkeys(l) command lets you change key mappings immediately. Entering 
loadkey s filename takes the table specified by filename and changes the key map¬ 
pings accordingly. If you type loadkeys without an argument, the system checks the 
dip switch settings on file bottom of the keyboard and reads in tlie appropriate 
layout nn file from /usr/share/lib/keytables. If you create your own k^ ta¬ 
ble in a directory other than /usr/share/lib/keytables, then you must specify 
the fitU pathname as an argument. The workstation uses the most recently specified ta¬ 
ble until you have to reboot tlie system. Wlien you or someone else log out and log 
back in, you must use the correct characters according to the current key table. 

The loadkeys(l) command replaces the setkeys(i) command used in the SunOS 
4.0 system. To display the currently loaded key mappings, use the duinpkeys(l) com¬ 
mand. 

You can also use User Defaults to reset the key mappings until the system is rebooted: 

1. Display the Desktop menu by pressing the riglit mouse button on the background 
portion of tlie screen. 

2 . Drag right on Services and select User Defaults. 

3. Go to the Input category either liy cycling through the selections or selecting it 
from tlie User Defaults menu. 

4. Enter the file name of the key table as a value for the Keyboard_Type parameter. 

5 . Select Save at tlie top of the window. 


Changing the Table 
for Current and 
Future Sessions 


36 



Sun386i Administrator's & Developer^s Notes - December 1988 


Sun386i Developer^ s Notes 


Specifying the 
Default Key Table 


Retaining a 
Nondefault Table 
Between Reboots 


DocumenitatiDn 

Changes 


If after loading a different key table yon cannot tell which characters are mapped to 
which key stations, you can recover by typing loadksys us. This resets the keyboard 
to tlie default (U.S.). 

If you cannot even locate the keys required to enter the loadkeys us command, try 
changing the setting via User Defaults as described in the previous section. In step 4, 
you can eitlier enter us or simply delete the value for tlie Key board JType parameter. 
When no £Qe is specified and you press Save, the system uses the default U.S. key map¬ 
pings. 

If for some reason you are unable to do either of these procedures, for instance if you 
can't even log in, you can reboot the system. During a reboot the system automatical¬ 
ly remaps die keys to the default U.S. values, provided you have not edited the 
/etc/rc - local file to specify die loading of a different key table. The next section 
provides more information on editing /etc/rc. local. 


If you always want to use a nondefault key table on a Sun386i system, as superuser in¬ 
clude one of the following two lines ki the /etc/rc. local file: 

loadkeys (to always use the keyboard dip switch settings) 

loadkeys filename (to always read die file specified) 


Sun386i Devetoper^s Guide replacement pages - Replacement pages for the 
Sun3S6i Developer's Guide are included with the Sun386i Developer's Toolkit Docu¬ 
mentation Set, which you receive if you purchase Sun386i Developer's Toolkit soft¬ 
ware. (These are the same replacement pages that were packaged with the 
Administrator's & Developer's Notes for SunOS 4.0.) The pages are three-hole 
punched so diat you can easily insert them into the manual if you haven't already. 
There are several errors in these pages; see the following notes. 


/£lles/vol. local directory - Page 204 of the replacement pages for the Sun3S6i 
Developer's Guide kicorrecdy shows the directory /files/vol. local; it should be 
/files/vol/local. 


/export/vol. local directory - Page 206 of the replacement pages for the 
Sun3S6i Developer's Guide incorrectly shows /export/vol. local as a link to 
/f iles/vol. local. Instead, /export/vol/local is a link to 
/files/vol/local. 


/stand directory - Page 199 of die Sun386i Developer's Guide should include a de¬ 
scription of the /stand directory, /stand is a directory that exists only on dlskful 
systems and contains the standalone diagnostics files boot. S386, copy, and 
tpboot .3386. 


loadkays(l) replaces setkeys(l) - The loadkeys(l) command replaces die 
setkeys(l) command on page 152 of the Sun386i Developer's Guide, The path to 
key map tables shown on this page has also changed. Key map tables are now located 
in the /usr/share/lib/keytables directory. 
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maap routine for Sun386l drivers - Page 91 of Wfiting Device Drivers shows an ex¬ 
ample of a driver mmap routine that is incorrect for tlie Sun386i system. Tlie following 
code works on all Sun architectures: 

♦include <machine/pte.h> 

fbinmap (dev, off, prot, numdevs, mb_devs, size) 
dev_t dev; 
off_t off; 
int prot, numdevs; 
struct mb^device **nib_devs; 
u_int size; 

{ 

struct pte pte; 

if ((u_int) off >= size) 
return (-1); 

mmu__getpte (mb_devs [minor (dev) ]—>md_addr + off, &pte) ; 
return (* (u__int *) &pte & PG__PFNUM) ; 

} 

SunOS Reference Manual Inserts - A package of insert pages for man pages accom¬ 
panies tlie Sun386i Owner’s Supplement Documentation Set. These include informa¬ 
tion on the following commands, new or updated for the Sun386i SunOS 4.0.1 release: 


bar(l), bar(5) 

load(l) 

cc(lv) 

loadc(l) 

dos(l) 

loadkeys(l) 

dumpkeys(l) 

modload(8) 

fdformatCl) 

modstat(8) 

fontedit(l) 

mount(8) 

f ont f 1 ip_t o__6 8 k(8) 

organ! zer(l) 

f ont f lip_to_i3 8 6(8) 

orgrc(5) 

getmntent(3) 

rarpd(8c) 

help(5) 

rwhod(8) 

help_open(l) 

start_applic(8) 

help_viewer(l), help_viewer(5) 

strip(l) 

i nput_f r om_de f aul t s(l) 

textedit(l) 

ipallocd(8C) 

unconfigure(8) 

kadb(8s) 

uucp(lc) 

kb(4m) 

vfont(5) 

keytables(5) 

ypsync(8) 

ld(l) 



init - The printed version of the init(8) page incorrectly states that for a secure sys¬ 
tem, when tlie console is marked secure in /etc/ttytab, a root password is re¬ 
quired before the system comes up in single-user mode. The on-line page correctly 
states that when the console is marked secure, the root password is required. 


cc(l) man page - Tlie -a option (used to insert code to count how many times each 
basic block is executed) is not supported on Sun386i systems, only on Sun- 2 ™^ 

Sun-3, and Sun-4 systems. The on-line cc(l) man page does not explicitly state this. 
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screenblank(l) man page - An additional undocumented option to the 
screenblank(l) command is tlie -1 option, which causes screenblank to display 
tlie Sun Microsystems logo when it closes the screen. 

uucp(l) man page - The on-line man page mentions /usr/lib/uucp/ADMIN. 

This file does not exist. All the configuration files go into /var/spool/uucp/sys. 

C Pfx>grammer*s Guide x comparing a long to a float - When comparing an un¬ 
signed long to a float, the Sun386i C compiler does not preserve the unsignedness 
m the comparison; the Sun-3 C compiler does. 


Perfforiflgmce The Sun386i system has a large, virtual memory system. However, whenever an appli- 

Yjp^ cation touches a page in memory and brings it into its working set, this puts a load on 

^ tlie system that creates tlie potential for thrashing. There are a number of processes 

like sync and daemons running in the background for mail, mounting, routing, and 
other network services that constantly compete for memory. Also, many users run 
more tlian one application at a time. All processes must compete for the same physi¬ 
cal memory. 

One of the major goals of the Sun386i 4.0.1 release was to increase the performance 
of the .system, particularly at the lower end of the product line. You can improve the 
performance of the programs you develop on the Sun386i system by following the sug¬ 
gestions below. (For specific C language guidelines, see tlie “Optimizing Code” sec¬ 
tion that starts on page 48 of the Sun3S6i Developer's Guide,) 

♦ Always look for the lowest-level way to perform a task. For instance, use system calls 
instead of library calls, and library calls instead of SunView calls whenever possible 
(note that this could make porting more difficult). Avoid creating multiple process¬ 
es, using pipes, and so on, to do tilings that you could accomplish with lower sys¬ 
tem overhead. 

♦ Avoid tying up large amounts of memory that a program isn’t currently using. For 
instance, allocate only the memory that is needed for a given task instead of allocat¬ 
ing enough memory for several separate tasks. 

♦ Where possible, use one system call and save commonly used data in a global vari¬ 
able. For instance, use the getdtablesize(2) system call to determine the maxi¬ 
mum number of open files (used as a parameter for tlie select system call), and 
tlien store that data in a global variable for use l>y other routines. This will enliance 
your program’s performance, but could make porting more difficult. 

♦ If an application frequently searches linked lists, create a header table or a linked 
list of headers that contain pointers to data instead of having data reside in each el¬ 
ement of a linked list. This is particularly important if each item in the list is large. 
Using a header table can result in many less pages being read into memory. 

♦ Push temporary data onto the stack. This enables many different variables to share 
the same physical memory. 

♦ Repainting a window in SunView requires that the process that owns tlie window be 
awakened and its pages brought into memory. Therefore, applications should auto¬ 
matically close after a specified time of inactivity. Closed applications take up less 
screen space, and tlierefore are repainted less frequently. The default Sun Organiz¬ 
er and Help Viewer applications automatically close to their iconic state after 10 
minutes of inactivity. 
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♦ If your application creates more than one window, try to ensure that windows don’t 
overlap by default. 

♦ Avoid u.sing clocks and other similar features that use up CPU time and physical 
memory with your application. 
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Standard Help 
Viewer Fonts 


The batchfont 
File 


More About Help Fonts 


This section lists the Frame Maker fonts that are shipped with the Sun386i system as of 
4.0.1, and explains how you can add more fonts li' you have purchased Frame Maker. 
I’he same Interleaf*^ TPS fonts that shipped with 4.0 are still available as of 4.0.1. See 
tlie Sun386i Developet 's Guide for details. 


Utiless otherwise indicated, all file names in this section are relative to: 

defaultJielpjdirectory /. . / . . / format/ 

where tlie default help directory, as defined in .defaults, is typically: 

/vol/help/language/USA-English/ 

The Frame Maker fonts available with 4.0 in the directory 
/vol/help/format/Frame/init/fontdir have been reduced in numl.>er, 
moved to the directory /vol/help/format/Frame/init/fontdir. sun386, 
and bitflipped (using /usr/bin/batchfont_create, explained in the next sec¬ 
tion). The 4.0.1 help_viewer reads fonts from the fontdir. sun386 directory in¬ 
stead of from the fontdir directory. Fonts shipped with 4.0.1 are: 

Courier—Boldl4.bfont 
Courierl2.bfont 
Courier14.bfont 
Frame-Romanl2.bfont 
Helvetica-Boldl2.bfont 
Helvetica-Boldl4.bfont 
Helvetica-Boldl8.bfont 
Helvetica-Bold24.bfont 
Helvetica—Obliquel4.bfont 
Helvetical2.bfont 
Helvetical4.bfont 
SymbollO.bfont 
Symboll2.bfont 
Symboll4.bfont 
Times—Romani2.bfont 

If you attempt to view a Frame Maker document (in help_viewer) containing fonts 
tliat help_viewer does not have loaded, help_viewer replaces these fonts with 
tlie default font, Times-Roman 12 point. 

4.0.1 help_viewer has been enhanced to enable it to read screen fonts from a spe¬ 
cially constructed batchfont file. The batchfont file consists of Frame Maker 
screen fonts that have been flipped ahead of time and stored together in a single file. 
Tliis allows help_viewer to map all its fonts at once and, since fonts are not altered. 
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Adding Frame 
Maker Fonts 


Locating Fonts 


to place them iii a read-only portion of memory. This enhancement improves both 
start-up time and virtual memory paging performance. 

If you look in the font list file in fontdir. sun386, you will see that all or most 
screen fonts have a new .batchfont extension. For example, 12-point Helvetica was 
specified as: 

<ScreenFont Helvetical2.bfont 2 0 12> 

in 4.0. As of 4.0.1 it is specified as: 

<ScreenFont Helvetical2.bfont.batchfont 2 0 12> 

To ensure backward compatibility, both formats are legal entries in the font list 
file. But when help_^viewer sees a .batchfont extension, it looks for a file called 
bat chfont and reads the font from it instead of from the file Helvetical2 .bfont, 
as was the case in 4.0. This improves performance. 

To see what fonts are contained in the batchfont file, type more batchfont. This 
displays a list of the font names, followed by the actual font binary data. Once you hit 
tlie binary data, quit out of more. (You could also use head batchfont—^see the 
head(l) man page for details.) 

You can create your own batchfont file by using the batchfont_create program 
in the /usr/bin directory. The syntax is: 

batchfont_create batchfont fonts 

vjherc fonts is a list of all the fonts you want to be in the batchfont file, separated by 
spaces. You must include tlie names of the 15 default Frame Maker fonts shipped with 
the system (see the preceding page) to be able to view Sun386i on-line handbooks. 

The batchfont file (or a link to it) must be in the directory 
. , / . . /Frame/init/fontdir. sun386 (relative to the default help directory as 
specifed in . defaults). Also, you must include entries in the fontlist file (in the 
same directory) for each font added. The next section explains how to add fonts. 


If you have Frame Maker and your help documentation requires additional Frame 

Maker fonts: 

1. Locate tlie fonts. You can probably find them in your $FMHOME/ .makerinit/ 
fontdir directory (see Frame Maker documentation for details). 

2. Copy (or make symbolic links to) whatever screen fonts you want from 
fontdir. sun38 6. 

3. Create a batchfont file as descrilied m the previous section. This step is option¬ 
al, but recommended for better help_viewer performance, 

4. Tell help_viewer which fonts you want it to load by editing the fontlist file. 

5. Quit and restart help_viewer. 

Tile following sections provide details. 


The Sun3B6i help_viewer Frame font directory is 

format/Frame/init/fontdir. sun386. This directory is relative to the default 
help directory, as designated in your defaults database. Typically, this is 
/vol/heIp/format/Frame/init/fontdir. sun386, which resolves to 
/usr/lib/help/format/Frame/init/fontdir.sun386. 
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Copying Fonts 


Editing tho 
fontllst File 


Font Addition 
Example 


If you aren’t adding many fonts, copy the fonts that you want from 
$FMHOME/ .makerinit/font dir to the destination directory, probably to 
/usr/lib/help/format/Frame/ init/ font dir. sun386. To add anything to 
/usr you must tecome superuser and remount the /usr partition to be writable (as 
shown in the example later in tliis section). You may also need to change the permis¬ 
sions in font dir. sun386 to make the files there writable as well. If there is not 
enough room in /usr, then you must put the additional fonts somewhere else (for ex¬ 
ample, leave them in $FMHOME/ .makerinit/fontdir) and create symbolic links 
to tliem instead. 

For each family of screen fonts, copy (or make a linlc to) the corresponding font-met¬ 
ric (. bfm) file if it is not already present in tlie destination directory. Each family of 
fonts has one .bfm file. For example: 

These screen fonts Require this . bfm file 

Helvetica?.bfont Helvetica.bfm 

Helvetica8.bfont 

Helvetica9.bfont 

HelveticalO.bfont 

Helvetical2.bfont 

Helvetical4.bfont 

Helvetical8.bfont 

Helvetica24.bfont 


help_viewer loads the fonts specified in the fontlist file in tlie 
fontdir. sun386 directory. In this file, you must tell help_viewer to load both the 
screen font and the . bfm font metric for each font you add. You can look at 
fontlist as a guide, either in tlie directory fontdir. sun386, fontdir, or in the 
Frame Maker directory $FMHOME/ .makerinit/fontdir. 

For instance, to add the screen font Helvetica? .bfont, which is not provided with 
the help_viewer, you would make these two entries in fontlist: 

<ScreenFont Helvetica?.bfont 2 0 ?> 

<FontMetric Helvetica.bfm 2 0 ?> 

In the fontlist file, font families are kept together and organized in increasing or¬ 
der ]yy size. Tlie fontlist file in fontdir. sun386 contains several screen fonts 
with a .batchfont extension, wliich means that help^viewer gets all of these fonts 
from tlie batchfont file. Note tliat tliere are no font file names that contain the 
.batchfont extension; this extension is used only in the fontlist file, to tell 
help_viewer to get the font from the batchfont file. 


Tliis section shows the steps to add Times-Roman 24 point to tlie current set of fonts. 
The Times-Roman font is $FMHOME/ .makerinit/fontdir/ 

Times-Roman24 .bfont. This example assumes that tlie rest of the fonts are physi¬ 
cally located in /usr/lib/help/format/Frame/init/fontdir, the standard 
place for both 4.0 and 4.0.1, and that links to these fonts exist in fontdir. sun386 
(new as of 4.0.1). 

1. cd /usr/lib/help/format/Frame/init/fontdir.sun386 

2. su 

3. mount -o remount /usr 


43 



Sun386i Developer^ s Notes 


Sun386i Administrator's & Developer^s Notes - December 1988 


4. chmod a+rw . batchfont fontlist 

5. exit 

6. cp batchfont batchfont. old (optional) 

7. rm batchfont 

8. batchfont^create batchfont \ 

../fontdir/Courierl2.bfont \ 

../fontdir/Courier14.bfont \ 

../fontdir/Frame~Roraanl2.bfont \ 

../fontdir/Helvetica-Boldl2.bfont \ 

. ./fontdir/Helvetica-“Boldl4 .bfont \ 

. . /fontdir/Helvetica-BoldlS.bfont \ 

../fontdir/Helvetica—Bold24.bfont \ 

../fontdir/Helvetica—Obliquel4.bfont \ 

../fontdir/Helvetical2.bfont \ 

../fontdir/Helvetical4.bfont \ 

. ./fontdir/SjwibollO.bfont \ 

. . /fontdir/S3/wiboll2. bfont \ 

. ./fontdir/Syinboll4.bfont \ 

. . /fontdir/Times-Roiiianl2.bfont \ 

$FMHOMDE>/ .xnakerinit/fontdir/Times—Raman24 .bfont 

If lliere is no room for the new batchfont, create it somewhere else and make a 
link to it, for example: 

batchfont_create ^/batchfont fontfilel,fontflle2, ... 

In -s -^/batchfont . /batchfont 

9. If Times-Roman. bfm doesn’t already exist in fontdir. sun386, enter the 
command: 

In -s $FMHOME/.i!iakerinit/fontdir/Tiines-Roraan.bfm 

10. cp fontlist fontlist. old (optional) 

11. textedit fontlist £ 

12. Following the format of fontlist, add these lines to the appropriate sections of 

fontlist (see Frame Maker documentation for file format details): 
<ScreenFont Times—Roman24.bfont.batchfont 1 0 24> 

<FontMetric Times—Roman, bfm 1 0 24> 

13. Save fontlist. 

14. Quit and restart help_viewer to view the new fonts. 

15. Type /etc/fastboot to restore read-only permission to the /usr partition. 
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Organizer 39 
command 38 
. orgrc file changes 33 
. orgrc file format 38 

F 

PC-NFS, toolkit for 33 

performance, suggestions for enhancing 30, 39-40 
printer 

adding 10 

adding to a non-Sun386i system 11 
programming, performance suggestions for 39-40 
protection violations 27 
publickey file 6 


quota command 26 
quotactl command 27 
quotaof f command 27 
quotaon command 27 

R 

rarpd command 38 
repainting windows 39 

replacement pages, for Sun3S6i Developer's Guide 
37 

repquota command 27 
root file system 11 
root logins, disabling 6 

RPC, sending commands to Help Viewer with 34 
rwhod command 38 

S 

SCSI driver 26 
sdO device 26 
secure 
NFS 6 

publickey issue 6, 7 
RPC applications 6, 7 
systems 38 
security 
C2 26 
NFS 26 

root logins, disabling 6 
server kit 14-25 

clusters, loading manually 21, 22 
diskless Sun386i clients, setting up 18-21 
diskless Sun386i clients, removing 23, 24 
files modified by 24, 25 
home directories 19 
sun386client script 19-21 
sun38 Sserver script 15-18 
setkeys command 36, 37 
shared 

libraries, accessing 29 
memory segment 29 
SHMPOOL definition 29 
SHMSIZE definition 29 
signal handler 27 
sscant function 29 
start__applic command 38 
strip command 38 
subnets 6 
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sun386client script 18, 19, 20 
Sun386i Developer's Guide, corrections 37 
sun386server script 15, 16, 17 
sun_external. info file 34 
SunLink DNI 8, 28 

SunOS Reference Manual, corrections 38-39 
SunView, repainting windows 39 
swap space, increasing 12 
sysacct command 26 
sysaudit command 26 
system installation 4 
diskful systems 4 
diskless into other networks 4 
Yellow Pages master 5 

T 

TCP code 26 
tcpdebug command 26 
terminal, adding 10 
text edit conmiand 38 
time zones 20 
tip command 29 

U 

ufs command 26 
unconfigure command 38 
unshared libraries, accessing 29 
user account, creating 8 
UUCP command 38, 39 
UUCP files 12 

V 

vfont file format 38 

W 

wds device 26 
windows, repainting 39 

Y 

Yellow Pages 

domain 14, 20 
master 5 

networks without 5 
ypsync format 38 
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